Eventos con WillCall

Esta sección describe cómo implementar eventos con la funcionalidad de WillCall en la plataforma de menta tech. Se detallan los parámetros necesarios al momento de la creación del evento y la emisión de tickets, así como las consideraciones clave para garantizar una correcta implementación.

¿Qué es WillCall?

WillCall es un proceso mediante el cual los boletos comprados para un evento se recogen en el lugar del evento en lugar de ser enviados electrónicamente o por correo. En otras palabras, el número de WillCall se utiliza para que los asistentes recojan sus entradas en la boletería del evento.

Este sistema se emplea para garantizar que los asistentes presenten una identificación adecuada y el código de retiro para obtener sus boletos. El objetivo de WillCall es proporcionar una forma segura y controlada de gestionar la distribución de boletos, evitando el riesgo de pérdida o fraude en el proceso de entrega.

Atención

Recuerden WillCall NO es una funcionalidad Obligatoria

Parámetros para la Creación de un Evento con WillCall

Para configurar un evento con WillCall, es esencial definir ciertos parámetros dentro del objeto configuration en el cuerpo de la solicitud al endpoint. Estos parámetros determinan el manejo de los tickets y el proceso de retiro. A continuación, se describe cada uno de estos parámetros en detalle:

Configuración de la Política de Retiro

Dentro del objeto configuration, la política de retiro de los tickets se configura con el parámetro policy bajo el subobjeto redemption. Los posibles valores para policy son:

NONE: Indica que el evento no requiere WillCall. Los tickets no necesitan ser presentados en la boletería del teatro.
OPTIONAL: El número de WillCall se incluye en el ticket junto con un código QR (Locator). Los asistentes pueden presentar el código en la boletería del teatro si lo desean, pero no es obligatorio.
MANDATORY: El WillCall es obligatorio para el evento. El ticket solo mostrará el número de WillCall sin el código QR. Los asistentes deben presentar el número de WillCall en la boletería para recoger sus tickets.

Configuración del Tiempo Antes del Evento

También dentro del objeto configuration, el parámetro hoursBeforeShow especifica cuánto tiempo antes del inicio del evento debe estar disponible el número de WillCall. Este valor se mide en horas y controla el período durante el cual los tickets pueden ser retirados.

Descripción: Define el período en horas antes del evento durante el cual el número de WillCall debe estar accesible. Usualmente, las plataformas de ticketing permiten el WillCall desde 2 semanas antes del evento. En el ejemplo, 168 horas equivalen a 7 días.

Instrucciones para el WillCall

El parámetro instructions proporciona información adicional sobre el proceso de WillCall. Este campo es especialmente útil para guiar a los usuarios en el momento del retiro de sus tickets.

Descripción: Ofrece instrucciones específicas sobre cómo los usuarios deben presentar el código de WillCall en la boletería. Por ejemplo, se puede indicar que deben presentar el código impreso o mostrado en su dispositivo móvil.
Ejemplo: 'Presentar el código de retiro en la boletería del teatro.'

Ejemplo de Configuración

Atención

Recuerden reemplazar "YOUR_API_KEY" por su clave de API Privada

Para obtener información detallada sobre los parámetros y configuraciones específicas que puedes utilizar, consulta la sección de datos y parámetros específicos.

A continuación, se presenta un ejemplo de configuración en formato JSON que ilustra cómo se definen estos parámetros:

cURL
Python
Java
PHP

A continuación les brindamos un ejemplo de cómo crear un evento, con datos ficticios, utilizando cURL.

    curl -X POST "https://api.mentatickets.com/v1/events"
    -H "Authorization: YOUR_API_KEY"
    --data-raw "{
        'title': 'The Lion King',
        'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
        'externalReferenceId': 'the-lion-king-broadway',
        'shows': [
            {
                'title': 'The Lion King in Broadway theatre',
                'status': 'LIVE',
                'images': [
                    {
                        'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
                        'kind': 'main'
                    }
                ],
                'showId': '4726',
                'date': '2022-04-02T14:00:00.000-04:00',
                'ticketOptions': [
                    {
                        'title': 'Asiento Estándar',
                        'ticketId': '0001',
                        'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
                        'price': 5500,
                        'currency': 'ARS'
                    },
                    {
                        'title': 'Asiento Premium',
                        'ticketId': '0002',
                        'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
                        'price': 13800,
                        'currency': 'ARS'
                    }
                ],
                'configuration': {
                    'redemption': {
                        'policy': 'OPTIONAL',
                        'instructions': 'Presentar el código de retiro en la boletería del teatro.',
                        'hoursBeforeShow': 168
                    }
                }
            }
        ],
        'location': {
            'city': 'New York City',
            'state': 'New York',
            'venueName': 'Broadway theatre',
            'address': '200 W 45th Street',
            'country': 'United States of America'
        }
    }"

A continuación les brindamos un ejemplo de cómo crear un evento, con datos ficticios, utilizando Python y la libreria requests.

import requests
import json

url = "https://api.mentatickets.com/v1/events"
api_key = "YOUR_API_KEY"
headers = {"Authorization": api_key}

data = {
    'title': 'The Lion King',
    'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
    'externalReferenceId': 'the-lion-king-broadway',
    'shows': [
        {
            'title': The Lion King in Broadway theatre',
            'status': 'LIVE',
            'images': [{
                    'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
                    'kind': 'main'
                    }],
            'showId': '4726',
            'date': '2022-04-02T14:00:00.000-04:00',
            'ticketOptions': [
                {
                    'title': 'Asiento Estándar',
                    'ticketId': '0001',
                    'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
                    'price': 5500,
                    'currency': 'ARS'
                },
                {
                    'title': 'Asiento Premium',
                    'ticketId': '0002',
                    'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
                    'price': 13800,
                    'currency': 'ARS'
                }
            ],
            'configuration': {
                'redemption': {
                    'policy': 'OPTIONAL',
                    'instructions': 'Presentar el código de retiro en la boletería del teatro.',
                    'hoursBeforeShow': 168
                }
            }
        }
    ],
    'location': {
        'city': 'New York City',
        'state': 'New York',
        'venueName': 'Broadway theatre',
        'address': '200 W 45th Street',
        'country': 'United States'
    }
}

response = requests.post(url, headers=headers, json=data)

A continuación les brindamos un ejemplo de cómo crear un evento, con datos ficticios, utilizando Java y la libreria OkHttp3.

import okhttp3.*;
import java.io.IOException;

    OkHttpClient client = new OkHttpClient();

    MediaType JSON = MediaType.parse("application/json; charset=utf-8");
    String json = "{
        'title': 'The Lion King',
        'description': 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
        'externalReferenceId': 'the-lion-king-broadway',
        'shows': [
            {
                'title': The Lion King in Broadway theatre',
                'status': 'LIVE',
                'images': [{
                        'url': 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
                        'kind': 'main'
                        }],
                'showId': '4726',
                'date': '2022-04-02T14:00:00.000-04:00',
                'ticketOptions': [
                    {
                        'title': 'Asiento Estándar',
                        'ticketId': '0001',
                        'description': 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
                        'price': 5500,
                        'currency': 'ARS'
                    },
                    {
                        'title': 'Asiento Premium',
                        'ticketId': '0002',
                        'description': 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
                        'price': 13800,
                        'currency': 'ARS'
                    }
                ],
                'configuration': {
                    'redemption': {
                        'policy': 'OPTIONAL',
                        'instructions': 'Presentar el código de retiro en la boletería del teatro.',
                        'hoursBeforeShow': 168
                    }
                }
            }
        ],
        'location': {
            'city': 'New York City',
            'state': 'New York',
            'venueName': 'Broadway theatre',
            'address': '200 W 45th Street',
            'country': 'United States'
        }
    }";

    RequestBody requestBody = RequestBody.create(JSON, json);

    Request request = new Request.Builder()
            .url("https://api.mentatickets.com/v1/events")
            .addHeader("Authorization", "YOUR_API_KEY")
            .post(requestBody)
            .build();

    try (Response response = client.newCall(request).execute()) {
        System.out.println(response.body().string());
    } catch (IOException e) {
        e.printStackTrace();
    }

A continuación les brindamos un ejemplo de cómo crear un evento, con datos ficticios, utilizando PHP y la libreria cURL

<?php
$url = "https://api.mentatickets.com/v1/events";
$api_key = "YOUR_API_KEY";
$headers = array("Authorization: {$api_key}");

$data = array(
    'title' => 'The Lion King',
    'description' => 'Más de 60 millones de personas de todo el mundo han venido a vivir la emoción y descubrir el esplendor del inigualable musical de The Lion King.',
    'externalReferenceId' => 'the-lion-king-broadway',
    'shows' => array(
        array(
            'title' => The Lion King in Broadway theatre',
            'status' => 'LIVE',
            'images' => array(
                array(
                    'url' => 'https://storage.googleapis.com/default_mentatickets-core/dd127bc9-1079-4bbc-9bab-c87acd27edb2_SOURCE.webp',
                    'kind' => 'main'
                )
            ),
            'showId' => '4726',
            'date' => '2022-04-02T14:00:00.000-04:00',
            'ticketOptions' => array(
                array(
                    'title' => 'Asiento Estándar',
                    'ticketId' => '0001',
                    'description' => 'Buena vista y buen audio. A una distancia de entre 40 y 60 metros del escenario',
                    'price' => 5500,
                    'currency' => 'ARS'
                ),
                array(
                    'title' => 'Asiento Premium',
                    'ticketId' => '0002',
                    'description' => 'Ubicado en la parte frontal del teatro, con excelente vista y un audio premium.',
                    'price' => 13800,
                    'currency' => 'ARS'
                )
            ),
            'configuration' => array(
                'redemption' => array( 
                    'policy' => 'OPTIONAL',
                    'instructions' => 'Presentar el código de retiro en la boletería del teatro.',
                    'hoursBeforeShow' => 168
                )
            )
        )
    ),
    'location' => array(
        'city' => 'New York City',
        'state' => 'New York',
        'venueName' => 'Broadway theatre',
        'address' => '200 W 45th Street',
        'country' => 'United States'
    )
    'producers' => array(
        array(
            'name' => 'New York Events Producer',
            'emails' => array('nyproductions@gmail.com'),
            'producerId' => '819'
        )
    )
);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

?>

Respuesta JSON

{
    "status": 200,
    "data": {EVENTDATA},
    "errors": null
}

Puntos Importantes a Tener en Cuenta y Consideraciones Adicionales

Actualización del Número de WillCall en la Compra de Tickets

Consideración importante en caso de utilizar un Nro de Orden como Nro de Willcall (Nro que contiene todos los boletos comprados en una misma transacción en venta primaria). Cuando se realiza una reventa de boletos en un evento con Willcall, se debe accionar de alguna de las siguientes maneras:

Generar un nuevo Nro de Orden para los boletos comprados por el usuario en reventa. Este nuevo número debe contener todos los boletos comprados en reventa.
En caso de no poder generar un nuevo Nro de Orden para los boletos comprados en reventa, se debe proporcionar un nuevo dato para que el usuario realice el Willcall. Este puede ser la dirección de correo electrónico del usuario, el ticketId o cualquier otro dato que soporte taquilla para realizar el Willcall.

En ambos casos, es crucial que el Nro de Orden original deje de contener los boletos revendidos, y que no sea posible que estos tickets revendidos se retiren en taquilla con el Nro de Willcall original. Estas acciones se deben realizar cuando se concreta una reventa y recibir el Webhook de Reventa realizada de ticket.update.

Actualización de Disponibilidad de Boletos

Cuando se realiza una venta, en el mercado secundario de menta, el número de WillCall original del comprador debe dejar de contener los boletos vendidos. Para esto es necesario utilizar el Webhook de menta Notificaciones Webhook de Reventa realizada Donde se podrán identificar los boletos vendidos y luego removerlos del comprador original.

Validación de Identidad

Utilice el Webhook de menta Notificaciones Webhook de Reventa realizada para obtener la información personal del usuario comprador. Esta información debe cargarse en el sistema para que la persona de taquilla pueda validar la identidad del comprador en reventa con su nueva información personal, reemplazando la del comprador de venta primaria.

Esta documentación debe servir como guía completa para la implementación de eventos con la funcionalidad de WillCall en la plataforma de menta tech. Para cualquier duda o consulta adicional, no dude en contactarnos.

¡Listo! Con sólo proporcionarnos esta información, ya podremos continuar al siguiente paso.

¿Qué es WillCall?​​

Parámetros para la Creación de un Evento con WillCall​

Configuración de la Política de Retiro​

Configuración del Tiempo Antes del Evento​

Instrucciones para el WillCall​

Ejemplo de Configuración​

A continuación, se presenta un ejemplo de configuración en formato JSON que ilustra cómo se definen estos parámetros:​

Puntos Importantes a Tener en Cuenta y Consideraciones Adicionales​

Actualización del Número de WillCall en la Compra de Tickets​

Actualización de Disponibilidad de Boletos​

Validación de Identidad​